home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Screenblankers / DreamOn / DreamOn.doc < prev    next >
Encoding:
Text File  |  1996-09-27  |  8.3 KB  |  256 lines
  1. **********************************************************************
  2. *                                                                    *
  3. *                 DreamOn  Version 1.0  ( 04/09/1995 )               *
  4. *                                                                    *
  5. *                       © 1995 by Uwe Schilling                      *
  6. *                                                                    *
  7. **********************************************************************
  8.  
  9.  
  10. DESCRIPTION:
  11. -----------
  12.  
  13. Who doesn't know the following situation:
  14.  
  15. You look at your code and the solution of all your problems is very
  16. close, but unfortunately your screen blanker makes "plopp" ( you
  17. can even hear it ) and you stare on a black screen and your great
  18. ideas are gone.
  19.  
  20.  
  21. This is history because there is DreamOn!
  22.  
  23.  
  24. What it does:
  25.  
  26. - blanks all visible screens -SOFT- in and out. No more loss of
  27.   concentration! Takes care of your nerves!
  28.  
  29. - allows you to use your favourite screen blanker additional. So I
  30.   have not to code all this ASwarm and FlyingToaster effects again and
  31.   you don't need to download a half megabyte.
  32.  
  33. - unblanks itself and other blankers when a new screen, window or
  34.   requester appears or when you insert or remove a disk. So you know
  35.   when you have to work again and it is not necessary to "poll" if the
  36.   picture is rendered or not.
  37.  
  38.  
  39. Other advantages are:
  40.  
  41. - low memory consumption because it needs no additional screen
  42.  
  43. - no waste of processor time in blanked state
  44.  
  45. - highly configurable with a nice GUI
  46.  
  47. - runs as a commodity
  48.  
  49. - supports the "save screen" feature from Fractalblanker
  50.  
  51. - all preferences will be saved in the icon ToolTypes
  52.  
  53.  
  54. USAGE:
  55. -----
  56.    from CLI:
  57.    --------
  58.    Type "DreamOn ?" to get the following information about the
  59.    program:
  60.  
  61.       DreamOn  V1.0  © Copyright 1995 by Uwe Schilling
  62.  
  63.       Usage: DreamOn [CX_PRIORITY=<number> (0)]
  64.                      [CX_POPUP=yes|no (no)]
  65.                      [CX_POPKEY=<string> (lshift lalt d)]
  66.                      [BLANKKEY=<string> (lshift lalt b)]
  67.                      [DUMMYKEY=<string> (shift f3)]
  68.                      [TIMEOUT=<number> (180)]
  69.                      [BLANK_SPEED=<number> (40)]
  70.                      [UNBLANK_SPEED=<number> (3)]
  71.                      [WATCH_SCREENS=yes|no (yes)]
  72.                      [WATCH_WINDOWS=yes|no (yes)]
  73.                      [WATCH_REQUESTERS=yes|no (yes)]
  74.                      [WATCH_DISKS=yes|no (yes)]
  75.  
  76.    The parameters have to be separated by spaces but inside the
  77.    equations are no spaces allowed!
  78.  
  79.    All defaults are shown in round brackets.
  80.  
  81.    What does the parameter mean exactly:
  82.  
  83.    CX_PRIORITY: Useless for start from CLI. In case of start from
  84.                 Workbench is determines the order in witch the tools
  85.                 in the WBStartup drawer are launched.
  86.  
  87.    CX_POPUP:    If "=yes" the parameter window appears on start.
  88.  
  89.    CX_POPKEY:   Key to show the parameter window.
  90.  
  91.    BLANKKEY:    Key to blank immediately. Doesn't work if the
  92.                 parameter window is visible.
  93.  
  94.    DUMMYKEY:    Pressing this key does -NOT- unblank DreamOn.
  95.                 Useful in connection with Fractalblanker by  Olaf
  96.                 'Olsen' Barthel, that allows you to save the rendered
  97.                 blanker pattern. Default is the default key from
  98.                 Fractalblanker to do this.
  99.  
  100.    TIMEOUT:     Time in seconds after that DreamOn begins to dim the
  101.                 screen.
  102.  
  103.    UNBLANK_SPEED
  104.    BLANK_SPEED: Determine how soft your screen will blanked and
  105.                 unblanked. The real speed depends on how many screens
  106.                 are visible and how many colors they have.
  107.                 Because in most cases you will wish to work after
  108.                 unblanking the screen the unblank time is much shorter
  109.                 than the blank time.
  110.  
  111.    WATCH_SCREENS
  112.    WATCH_WINDOWS
  113.    WATCH_REQUESTERS
  114.    WATCH_DISKS: the banker takes care on all of this actions if you
  115.                 allow they.
  116.  
  117.  
  118. IMPORTANT!: If you use an additional blanker set "WATCH_SCREENS=no"
  119. ----------  and "WATCH_WINDOWS=no"! Otherwise if the other blanker
  120.             pops up its screen DreamOn would unblank itself and blank
  121.             again after TIMEOUT itself -AND- the alien blanker.
  122.             This is not what we want.
  123.  
  124.             Make sure that the timeout of the alien blanker is a
  125.             little bit longer than the timeout of DreamOn!
  126.  
  127.             ( technical note: If you set "WATCH_SCREENS=no" or
  128.               "WATCH_WINDOWS=no" only the first screen/window after
  129.               blanking will not force DreamOn to unblank. Additional
  130.               screens/windows will do this. )
  131.  
  132. Hint: Not all things that look like a requester are really requesters!
  133. ----  For instance DirOpus "requester" are windows!
  134.  
  135.  
  136.    A typical startup-sequence entry for usage with an additional
  137.    screen blanker may look as following:
  138.  
  139.    run >NIL: <NIL: c:DreamOn WATCH_SCREENS=no WATCH_WINDOWS=no
  140.  
  141.  
  142.    from Workbench:
  143.    --------------
  144.    Double-Click on the icon. If nothing happens it is OK.
  145.  
  146.    You can define in the Icon the same ToolTypes like described above
  147.    plus the additional ToolType "DONOTWAIT", that prevents you from
  148.    interrupt the Boot process, if you have DreamOn in your
  149.    WBStartup drawer.
  150.  
  151.  
  152.    Changing Parameters:
  153.    -------------------
  154.    By start with "CX_Popup=yes" or pressing the PopKey you get the
  155.    parameter window on the screen.
  156.  
  157.    From here you can change all parameters and save they in the
  158.    icon by click on the "Save" gadget.
  159.  
  160.    The Close gadget in the upper left corner closes only the window
  161.    without removing the blanker.
  162.  
  163.    To remove the blanker press "Quit" in the parameter window or start
  164.    DreamOn again.
  165.  
  166.  
  167. REQUIREMENTS:
  168. ------------
  169.  
  170. - DreamOn needs AGA because it is impossible to blank soft with only
  171.   16 values per color.
  172.  
  173. - To run the program successful you need the following libraries in
  174.   Libs: commodities.library, icon.library and gadtools.library.
  175.  
  176.  
  177. INSTALLATION:
  178. ------------
  179.  
  180. Copy DreamOn and DreamOn.info to where ever you want. ( The best place
  181. is of course the WBStartup drawer. ) Copy the doc-file on a clean, dry
  182. and delete protected place. And that's it.
  183.  
  184.  
  185.  
  186. BUGS ( I mean other Features ):
  187. ------------------------------
  188.  
  189. - Unlike most other blankers I can't delete the first key press, that
  190.   unblanks the screen because with a half blanked screen you will wish
  191.   to work as usual.
  192.   That means if you unblank by pressing a key you will get the key
  193.   code in the active text window or CLI. Be aware of this!
  194.  
  195. - screens with changing palettes: In this case the banker fights with
  196.   the program that owns the screen. Both of them change the palette
  197.   and in case that the program changes the palette continually ( i.e.
  198.   animations or some blankers ) you will see a increasing flickering
  199.   until the screen is blanked completely ( that means DreamOn is
  200.   thinking the screen is blanked ). Don't be worry about this, its not
  201.   dangerous for the program. In the Moment I have no idea how to
  202.   recognise this screens easy and without "hack" or patch of
  203.   additional library entry points.
  204.  
  205.   For other blankers exist the possibility to use "WATCH_SCREENS=no"
  206.   and "WATCH_WINDOWS=no" and set the blank time of the alien blanker
  207.   higher than the blank time of DreamOn.
  208.  
  209.   For HAM-sreens exists also a easy solution and so DreamOn recognised
  210.   this screens and does nothing with them.
  211.  
  212.   PCHG-pictures look only ugly after blanking.
  213.  
  214.  
  215. COPYRIGHT:
  216. ---------
  217.    DreamOn is copyrighted 1995 by Uwe Schilling. All rights reserved.
  218.    This program is Freeware, so no financial donations are required.
  219.    Redistribution will be allowed only if the package contains the
  220.    following unchanged files:
  221.  
  222.    - DreamOn
  223.    - DreamOn.info
  224.    - DreamOn.doc
  225.    - DreamOn.doc.info
  226.    - DreamOn.dok
  227.    - DreamOn.dok.info
  228.  
  229.    For using them in commercial products, the written permission of
  230.    the author is required. Usage in magazines and diskmags will be
  231.    allowed, if you send me a copy of this publication.
  232.  
  233.  
  234. DISCLAIMER:
  235. ----------
  236.    The author does not accept any responsibility for this program as
  237.    to reliability, correctness etc.  You use DreamOn completely at
  238.    your own risk.
  239.  
  240.  
  241. THANKS:
  242. ------
  243.  
  244.    go to my beta tester Amadeus ( from Recall ).
  245.  
  246.  
  247. AUTHOR:
  248. ------
  249.    For questions, bug reports, ideas contact me at
  250.  
  251.    Uwe Schilling             uwe@rahul.net ( only until 4/20/95 )
  252.    Laubestraße 20            fribmhf7.ibmmail.com ( 4/20- 5/20/95 )
  253.    D-01309 Dresden
  254.    Germany                 
  255.  
  256.